!FontManager release two script format.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 !Note! -> FILETYPE : &3f8.

-----------------------------------------------

The new scripts
~~~~~~~~~~~~~~~

This document describes the format for the current release and version of 
!FontMGR. Previous to release 2 the format was rather messy, and I have 
decided to make those files void now because of the huge improvement.

The new format is a script one, so you can edit in a text editor or 
wordprocessor. This will make it easier for you to edit and create files. The
current format will be added to if required. Ocassionally things will be
removed. Third parties are welcome to have their applications export
font manager scripts.

Please use the supplied icon however.

-----------------------------------------------

Below is an example file generated by !FontMGR2
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
FMGR

#Script file for Font Manager 2
#Details of file freely available from the Font Manager 2 application.
#Script generated Sat 24 Mar 2001 20:15:42 

*FILE_VERSION* : 0.10

*GROUPS*
{
 Default
 Eastern
 San-Serif
 Serif
 OvationPro
 Voyager
}

*SELECT* : Default

*GROUP_ORDER*
{
 Western
 Default
 Eastern
 San-Serif
 Serif
 OvationPro
 Uncial
 Voyager
}

*END*
-----------------------------------------------

Discussion on the above file.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The first line of the file must be FMGR, with no trailing spaces. If this is
not the case, then !FontMgr2 will give an error message.

Comments may appear anywhere after the first line, and must be preceded
by a # character.

Case of keywords is not significant. Whitespace is only significant in
separating values in a list from one another, and you may have as much
or as little as you wish.

*FILEVERSION*, if it occurs, must be the first keyword to occur after FMGR.
This shows the version of the scripting language in use (currently version
0.10).

Subsequent items may be in any order, or repeated (in which case they merely
add to the previous occurence of the list), up to the *END* item.

The '*GROUPS*' item contains a list of groups to be activated.

The '*SELECT*' item selects the specified group. If the group is not
available, then it is not defined what is selected.

The '*GROUP_ORDER*' item specifies the order in which groups should be listed
(and included in Font$Path).

The '*FLAGS*' item may be found in older script files. It specifies various
configuration items, which belonged more properly in the !FontMgr2
configuration file. It will be ignored if found (or errored on v0.10 scripts).

The '*END*' marker stops processing of the file. Any data after this line will
be ignored when reading the script.

-----------------------------------------------

Using the File Format
~~~~~~~~~~~~~~~~~~~~~

By giving you, the public a full description of this very very simple file 
format I hope that you will feel free to include the exporting of Font Manager 
scripts from your applications.

--==> PLEASE USE THIS FILE FORMAT !!! <==--

Also, it is essential that you maintain the file's iconsprite, and keep it 
attached to the filetype. DO NOT CREATE YOUR OWN!!!!

I am aware of third-parties writing commerical font managers and I would be 
only too happy for them to also use this file format, and the font hunter 
feature below. However please do not 'add' features to the file format without
discussing the change with me first.

-----------------------------------------------

The Font Hunter
~~~~~~~~~~~~~~~~

The 'font hunter' feature is primarily designed to help programmers get their 
applications to integrate with FontMGR2. Below is an example of how it might 
appear in a file.

*FONTS*
{
 NewYorker
 Folio
 Futura1
 Olivia
}

Its layout is similar to the "*GROUPS*" item. When the script is being
processed by !FontMGR2, any groups that contain any of the listed fonts are
enabled.

This is the 'engine' of application support of !FontMGR2 and also is the means
by which DocScan works.

This may also be useful for people moving files from computer to computer. 
Saving a "*FONTS*" version of a script is now supported via the Font Manager 2 
interface.

If you have a space or other exotic character in a font name, it should be
escaped with a backslash (\).

-----------------------------------------------

History
~~~~~~~

Version 0.02
	Version originally released.

Version 0.03
	Removed UNLIMITED_PATHS (unused) and EXPORT_AS_FILER_DIRECTORY
	(redundant) keywords from the *FLAGS* entry.

Version 0.10 (Released with v1.10)
	Remove the flags entry entirely. Made the white space and commenting
	more flexible. Added some syntax checks.

Version 0.11 (Released with v1.15)
	Added "\" escape to script files.
